revGoToFramePaused

Type

command

Summary

No longer supported, and included for backwards compatibility only. Moves an animation created in the Animation Builder to the specified frame.

Syntax

revGoToFramePaused <animationName>,{<keyFrameName> | <frameNumber>}

Description

The revGoToFramePaused command operates on animations created with the Animation Builder, which was included in versions of LiveCode older than 2.5. It is no longer supported.

Use the revGoToFramePaused command to move an animation to its starting frame before playing, or to restore it to a frame after playing.

Animations were created with the Animation Builder, which is no longer available. It was removed in LiveCode 2.5.

The animationName must be an animation that was created on the current card of the defaultStack.

To play an animation while allowing other handlers to execute, use the revGoToFramePause command repeatedly for each frame, using the send command :

    on goNextFrame theFrame -- 1 frame every 20th of a second
        revGoToFramePaused \"My Animation\",theFrame  
        send (\"goNextFrame\" && (theFrame + 1)) to me in 3 ticks
    end goNextFrame

Important

The revGoToFramePaused command is part of the Animation library. To ensure that the command works in a standalone application, you must include this custom library when you create your standalone. In the Inclusions pane of the Standalone Application Settings window, make sure the "Animation" library checkbox is checked.

Parameters

Name	Type	Description
animationName		An expression that evaluates to the name of an animation on the current card.
keyFrameName		The name of a key frame in the animation.
frameNumber		The number of any frame.

Examples

revGoToFramePaused "Fireworks",25 -- go to frame 25

revGoToFramePaused (field "Current Animation"),(field "current Frame")

Related

command: revStopAnimation, group, send

glossary: current card, main stack, handler, frame, message, Standalone Application Settings, standalone application, command, application, LiveCode custom library

library: Animation library, library

message: startup, openBackground, preOpenStack, openStack, preOpenCard

property: defaultStack

Compatibility and Support

Introduced

LiveCode 1.0

Platforms

desktop

server